home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / ust1a.arc / README.UT1 < prev    next >
Encoding:
Text File  |  1985-09-05  |  4.1 KB  |  125 lines
  1. Here are a few simple tools that run identically or very similarly
  2. under msdos and unix. 
  3.  
  4. I am calling them ust1, Unix Style Tools. Couldn't come up with 
  5. a better name.
  6.  
  7. They have only minimally been tested under msdos and bsd4.2.
  8. MSC 3.0 was used under msdos.
  9. I did make an effort to make the code portable. They probably would 
  10. run under a few other systems.
  11.  
  12. Mail bug reports and problems to me. I'll re-post.
  13.  
  14. expand:
  15.  *  Expand mimics Unix's expand. It is not a full implementation.
  16.  *  Does not support [-tab1,tab2,..,tabn].
  17.  *  Expand is a filter.
  18.  *  It processes the named files or the standard input.
  19.  *  It writes to standard output with tabs changed into blanks.
  20.  *  
  21.  * Usages:
  22.  *  expand [-tabstop] [i_files]
  23.     Back space can easily be added to it.
  24.  
  25. dost2b:
  26.  *  dost2b is a filter.
  27.  *  dost2b processes i_files or the standard input.
  28.  *  dost2b writes to o_file or standard output.
  29.  *  Converts a DOS text file to binary file.
  30.  *  Replaces <cr><lf> to <lf>.
  31.  *
  32.  * Usages:
  33.  *  dost2b [-o] <o_file> <i_files>
  34.  
  35. dosb2t:
  36.  *  dosb2t is a filter.
  37.  *  dosb2t processes i_files or the standard input.
  38.  *  dosb2t writes to o_file or standard output.
  39.  *  Converts a DOS binary file to text file.
  40.  *  Replaces <lf> with <cr><lf>.
  41.  *  
  42.  * Usages:
  43.  *  dosb2t [-o] <o_file> <i_files>
  44.  
  45. hxd:
  46.  *  hxd, Hexadecimal dump is similar unix's "od -x"
  47.  *  Displays the contents of a file in hexadecimal.
  48.  *  If a byte is printable, it is also printed.
  49.  *  For each in put file name of the file is first emited.
  50.  *      file: <i_file>
  51.  *  last line for each input file is length of the file in 
  52.  *      "dec_add:hex_add" format.
  53.  *
  54.  * Usages:
  55.  *  hxd [-o] <o_file> <i_files>
  56.     See Comments in hxd.c.
  57.  
  58. which:
  59.  *  Tries to mimic Unix's which as closely as possible.
  60.  *  
  61.  * Usages:
  62.  *  which <i_files>
  63.     This is basically Larry Barello's which. 
  64.     For DOS .{com,exe,bat} are tested for existance.
  65.     Only the first one that exists is printed.
  66.     Internal DOS programs could later be added.
  67.  
  68. crc16:
  69.     This is basically Hugh Redelmeir's version.
  70.     I needed to modify it so that it could also be
  71.     used by sarch.
  72.  
  73. sarch:
  74.  *      This is a simple archive utility program.
  75.  *      Sarch tries to only rely on the C stdio library functions.
  76.  *      When transferring multiple files between two machines that only have a
  77.  *      single file transfer utility, sarch becomes handy. Multiple files
  78.  *      are converted to a sinle file on one end, transfered to the other 
  79.  *      machine and extracted to the original files at the destination.
  80.  *      System dependent features are very few, keeping it simple
  81.  *      and portable. Efficiency is sacrificed for portability.
  82.  *      CRCs are computed when updateing and when extracting.
  83.  *  
  84.  * Usage:
  85.  *  sarch -{m,u,x,a,t} archname file1 .. filen
  86.  *      -m      Print file names within the archive.
  87.  *      -u      Add or update files to the archive.
  88.  *      -x      Extract files from archive.
  89.  *      -a      Extract all files from the rachive.
  90.  *      -t      PCDOS related. When extracting, test mode is set.
  91.     Sarch is NOT COMPLETE. 
  92.     I am posting it because it can be useful if used carefully.
  93.     No flames on this one, please.
  94.     I am also not happy with th command syntax.
  95.     Only -u and -a work. As is, it is only useful for moving files
  96.     around. 
  97.     sarch -u ar file1 filen   , on one end.
  98.     sarch -a ar , on the other end.
  99.  
  100.  
  101. FILES:
  102.     mkp:
  103.         Is a Csh script that runs make.
  104.         It can be useful when you are supporting native and cross
  105.         development. Some don't like it. I do.
  106.     makefile:
  107.         File dependencies only. Needs mkp.
  108.     pcust1.bat:
  109.         run this on the pc to create everything.
  110.     mbstd.h:
  111.         Standard Header I use.
  112.     expand.c dost2b.c dosb2t.c hxd.c sarch.c which.c fcrc16.c crc16.c:
  113.         C source files.
  114.     readme.ut1:
  115.         This file.
  116.     
  117. TO RUN:
  118.     bsd4.2
  119.         first make mkp executable.
  120.         mkp 
  121.     msdos, msc
  122.         make sure that all headers and libraries are there.
  123.         make sure ssetargv.obj is in current directory.
  124.         run pcust1.bat
  125.